EnterAct is now being shipped in compressed form. Since you're reading this, you're already past the decompression stage, and have a single "EnterAct stuff" folder with lots of files in it, including this one. Place the contained files in accordance with the guidelines below, and you're ready to go.
When you use EnterAct, it will need about two more Megabytes on your hard disk for its log file, and each project you create will need 1-2 Meg (for a typical bunch of files and a fully-built dictionary).
After you've installed EnterAct, give it a partition of 4 Meg (the default): if you can't, 3 otherwise, 2 if you must but be prepared to be very selective about which files you incorporate into your project (see the doc "EnterAct memory needs" if memory is tight).
"EnterAct stuff" contents:
--------------
(EnterAct Scripts)
EnterAct 3 (application)
EnterAct 3 Manual
EnterAct in brief
EnterAct Memory Needs
EnterAct's magic clipboard
Rd me EnterAct 3
Installing EnterAct 3/tt (this document)
Minimal App7 ƒ: (source)
Drag_on Modules:
hAWK (CODE resource)
Read Resource (CODE resource)
hAWK programs: (many programs in several folders)
Read Resource Manual
hAWK User’s Manual
Debugging hAWK programs
Minimal App7 (application)
hAWK_notes.h
hAWK project:
hAWK.π
AWK Source:
AWK Headers:
Libraries:
COPYING hAWK
Read Res project:
ReadRes.π
Read_Res Source:
Read_Res Headers:
code to call Drag_ons:
write your own Drag_on:
(note a : above indicates a folder)
What goes where
EnterAct likes to distinguish between system headers
and source (eg toolbox headers, library source and headers)
and the files that belong to a particular project. Files within
the same folder that contains EnterAct count as <system>
files, and those located elsewhere are "project" files.
In general, decide which files you want to count as
system files, and place EnterAct at the top level of
the folder that contains those files (typically, they
will be in subfolders). If you have alternate versions
of some headers, try to place EnterAct low enough
in your folder hierarchy that only one set of the
alternates is contained within EnterAct's folder.
If you can't do that, don't worry, just place EnterAct
at the top level of the folder on your hard disk that
contains the toolbox headers etc you wish to use.
For Symantec users, that would be the same folder
that contains your THINK Project manager, at the
same level. For CodeWarrior, drop EnterAct into the
"Metrowerks C/C++ ƒ" folder so it ends up beside
the "MW C/C++ ..." compiler. For MPW, place EnterAct
beside the MPW Shell.
(Whenever you create a new project, a dialog will ask you
to select a <system> folder. If the folder that contains
EnterAct is the right one (ie it contains the appropriate
toolbox headers) then you can just cancel the dialog.
Otherwise, you should select the folder that contains
the appropriate compiler for your project.)
After placing EnterAct itself, put the "Drag_on Modules"
folder right beside it. (Optional) put the "Minimal App7" application
right beside it as well. Minimal App comes with
source code, showing how you can call Drag_on Modules
from your own app (source code is in "Minimal App7 ƒ" on
disk 1). This source code is used in the "Whirlwind tour"
section of the manual (but you can use your own source if
you prefer).
The "(EnterAct Scripts)" folder should also go beside EnterAct itself.
To access THINK Reference or Toolbox Assistant from EnterAct:
have a folder named "Tools" or "(Tools)" in the same folder as
EnterAct, at the same level, and drop aliases of THINK Reference
and/or QuickView into it. There are separate commands under
EnterAct's "Search" menu to access these. You can access both
during the same session of course.
Placement of the remaining files is entirely up to you,
no harm just leaving them in the "EnterAct stuff" folder.
You will probably want all of the manuals for reference,
especially the EnterAct and hAWK manuals, so don't trash
them just yet. The manuals are best viewed with EnterAct
itself, since you won't see the illustrations with other
editors. To make life simpler, when you create an
EnterAct project use the "Add Files..." command to add
the EnterAct manual and any others to your project.
Manuals and other non-code documents appear in the
rightmost pane of your project window, available with
a double-click.
"hAWK_notes.h" is a reference file for hAWK, containing notes on
hAWK that can be quickly accessed from within an EnterAct
project. More about notes in the "lookup tips" chapter in the EnterAct
manual.
Also included, projects and complete source for hAWK and
Read Resource, as well as Minimal App 7. This is all looking
a bit old now, not recommended viewing for beginners. But it
does work, and the hAWK code at least shows how to bolt a
Mac-friendly front end onto a DOS-type tool.
Verification
When you start up EnterAct, check under the "EnterAct" menu, and
you will see "hAWK" and "Read Resource" listed at the bottom if
things have ended up in the right places. Wherever you put
EnterAct, you should put the complete "Drag_on Modules" folder
